PowerTools ActiveReports for .NET 9.0J > ActiveReportsユーザーガイド > 概念 > エクスポート > 描画拡張機能 > PDFへの描画 |
Portable Document Format(PDF)は、印刷やエクスポートに適した形式です。レポートをこの形式でエクスポートするには、PDFRenderingExtensionを使用します。PDF描画拡張機能では、フォントリンク、デジタル署名、外字(EUDC)などの機能を使用することも可能です。
レポートをPDFでエクスポートするには、プロジェクトに以下のアセンブリへの参照を追加します。
レポートをPDF形式でエクスポートする方法の一例を以下に示します。
Visual Basicコード(Form Loadイベント内に貼り付けます。) |
コードのコピー
|
---|---|
' エクスポートするレポートを読み込み、ドキュメントオブジェクトを生成します。 Dim report As New GrapeCity.ActiveReports.PageReport(New System.IO.FileInfo("C:\Sample_PageReport.rdlx")) Dim reportDocument As New GrapeCity.ActiveReports.Document.PageDocument(report) ' 出力先のディレクトリを作成します。 Dim outputDirectory As New System.IO.DirectoryInfo("C:\MyPDF") outputDirectory.Create() ' エクスポートの各種設定を行います。 Dim pdfSetting As New GrapeCity.ActiveReports.Export.Pdf.Page.Settings() Dim setting As GrapeCity.ActiveReports.Extensibility.Rendering.ISettings = pdfsetting ' RenderingExtensionを使用し、レポートをエクスポートします。 Dim pdfRenderingExtension As New GrapeCity.ActiveReports.Export.Pdf.Page.PdfRenderingExtension() Dim outputProvider As New GrapeCity.ActiveReports.Rendering.IO.FileStreamProvider(outputDirectory, System.IO.Path.GetFileNameWithoutExtension(outputDirectory.Name)) reportDocument.Render(pdfRenderingExtension, outputProvider, pdfSetting) |
C#コード(Form Loadイベント内に貼り付けます。) |
コードのコピー
|
---|---|
// エクスポートするレポートを読み込み、ドキュメントオブジェクトを生成します。 GrapeCity.ActiveReports.PageReport report = new GrapeCity.ActiveReports.PageReport(new System.IO.FileInfo(@"C:\Sample_PageReport.rdlx")); GrapeCity.ActiveReports.Document.PageDocument reportDocument = new GrapeCity.ActiveReports.Document.PageDocument(report); // 出力先のディレクトリを作成します。 System.IO.DirectoryInfo outputDirectory = new System.IO.DirectoryInfo(@"C:\MyPDF"); outputDirectory.Create(); // エクスポートの各種設定を行います。 GrapeCity.ActiveReports.Export.Pdf.Page.Settings pdfSetting = new GrapeCity.ActiveReports.Export.Pdf.Page.Settings(); GrapeCity.ActiveReports.Extensibility.Rendering.ISettings setting = pdfSetting; // RenderingExtensionを使用し、レポートをエクスポートします。 GrapeCity.ActiveReports.Export.Pdf.Page.PdfRenderingExtension pdfRenderingExtension = new GrapeCity.ActiveReports.Export.Pdf.Page.PdfRenderingExtension(); GrapeCity.ActiveReports.Rendering.IO.FileStreamProvider outputProvider = new GrapeCity.ActiveReports.Rendering.IO.FileStreamProvider(outputDirectory, System.IO.Path.GetFileNameWithoutExtension(outputDirectory.Name)); reportDocument.Render(pdfRenderingExtension, outputProvider, pdfSetting); |
ActiveReportsには、レポートをPDFにどのようにエクスポートするかを制御するオプションが用意されています。
プロパティ | 説明 |
---|---|
Application | PDFビューワアプリケーションの[文書のプロパティ]ダイアログで[アプリケーション]に表示する値を設定します。 |
Author | PDFビューワアプリケーションの[文書のプロパティ]ダイアログに表示される[作成者]の名前を入力します。 |
CenterWindow | Trueに設定すると、ドキュメントは画面の中央に表示されます。既定値はFalseです。 |
Columns | レポートの列数を設定します。レポートのオリジナルの設定は、この値によってオーバーライドされます。既定値の-1は、レポートのオリジナルの設定を使用することを意味します。 |
ColumnSpacing | レポートの列の間隔(インチ単位)を入力します。レポートのオリジナルの設定は、この値によってオーバーライドされます。 |
DisplayMode | ドキュメントを開いたときにどのように表示するかを指定します。FullScreenモードは、メニューバー、ウィンドウコントロール、その他のウィンドウを表示せずにドキュメントを表示します。 |
DisplayTitle | Trueに設定すると、ドキュメントのタイトルが設定されている場合に、ウィンドウのタイトルバーにそのタイトルが表示されます。Falseに設定すると、PDFファイルの名前が表示されます。既定値はFasleです。 |
DpiX | 出力するPDFファイルの水平解像度を設定します。 |
DpiY | 出力するPDFファイルの垂直解像度を設定します。 |
Encrypt | ドキュメントが暗号化されるかどうかを決定します。 メモ: EncryptがFalseに設定されている場合、ユーザー許可とパスワードは無効になります。 |
EndPage | レポート内のレンダリングする最後のページ。既定値はStartPageの値(すなわち、0)です。 |
FallbackFonts | 元のフォントからグリフを検索するため、フォントファミリ名のカンマ区切りの文字列を取得または設定します。 |
FitWindow | Trueに設定すると、ドキュメントのウィンドウ(ビューワの内部ウィンドウ)は必ず初期設定のサイズで表示されます。既定値はFalseです。 |
HideMenubar | Trueに設定すると、ドキュメントを表示するビューワアプリケーションのメニューバーを非表示にします。既定値はFalseです。 |
HideToolbar | Trueに設定すると、ドキュメントを表示するビューワアプリケーションのツールバーを非表示にします。既定値はFalseです。 |
HideWindowUI | Trueに設定すると、ドキュメントウィンドウのユーザーインタフェース要素(スクロールバーやナビゲーションコントロールなど)を非表示にしてドキュメントの内容だけが表示されます。既定値はFalseです。 |
ImageInterpolation | 画像の補間値です。ファイルをPDFにエクスポートするときに画像補間を有効にするかどうかを指定します。 |
Keywords | ドキュメントに関連付けられたキーワードを設定します。 |
MarginBottom | レポートの下余白の値(インチ単位)をインチ単位で取得または設定します。整数または小数値の後に"in"を付ける必要があります(例: 1in)。レポートのオリジナルの設定は、この値によってオーバーライドされます。 |
MarginLeft | レポートの左余白の値(インチ単位)をインチ単位で取得または設定します。整数または小数値の後に"in"を付ける必要があります(例: 1in)。レポートのオリジナルの設定は、この値によってオーバーライドされます。 |
MarginRight | レポートの右余白の値(インチ単位)をインチ単位で取得または設定します。整数または小数値の後に"in"を付ける必要があります(例: 1in)。レポートのオリジナルの設定は、この値によってオーバーライドされます。 |
MarginTop | レポートの上余白の値(インチ単位)をインチ単位で取得または設定します。整数または小数値の後に"in"を付ける必要があります(例: 1in)。レポートのオリジナルの設定は、この値によってオーバーライドされます。 |
OwnerPassword |
リーダーに入力するオーナーパスワードを設定します。これは指定されたユーザー許可にかかわらずドキュメントへのフルアクセスを許可します。オーナーパスワード設定しない場合、セキュリティ設定を変更できません。 |
PageHeight | レポートのページ高さの値(インチ単位)をインチ単位で取得または設定します。整数または小数値の後に"in"を付ける必要があります(例: 1in)。レポートのオリジナルの設定は、この値によってオーバーライドされます。 |
PageWidth | レポートのページ幅の値(インチ単位)をインチ単位で取得または設定します。整数または小数値の後に"in"を付ける必要があります(例: 1in)。レポートのオリジナルの設定は、この値によってオーバーライドされます。 |
Permissions | ドキュメントに対するユーザー許可を指定します。カンマを使用して複数のユーザー許可値を組み合わせることができます。AllowFillin、AllowAccessibleReaders、AllowAssemblyのユーザー許可を使用する場合は、Use128BitプロパティをTrueに設定する必要があります。 |
PrintLayoutMode | PDFドキュメントに使用するレイアウトモードを指定します。 |
SizeToFit | PDFのページを選択した用紙サイズに合わせるかどうかを指定します。 |
StartPage | 描画するレポートの最初のページです。値が0の場合は、すべてのページが描画されます。既定値は1です。 |
Subject | ドキュメントのサブタイトルを設定します。 |
Title | ドキュメントのタイトルを設定します。 |
Use128Bit | Trueに設定すると、高水準の128ビットRC4暗号方式を使用します。Flaseに設定すると、低水準の40ビットRC4暗号方式を使用します。 |
UserPassword | リーダーに入力するユーザーパスワードを設定します。このプロパティ値が空白の場合、ドキュメントを開いた時にパスワードを入力するダイアログは表示されません。ただし、指定されたユーザー許可によって操作は制限されます。 |
WatermarkAngle | PDFドキュメント上のウォーターマーク(透かし)の角度を指定します。有効な値の範囲は0〜359で、0は水平(左から右)です。 |
WatermarkColor | PDFドキュメント上のウォーターマーク(透かし)のテキストの色を選択します。透かしの色の既定値はグレーですが、任意のWebカラー、システムカラー、カスタムカラーを選択できます。 |
WatermarkFont | ウォーターマーク(透かし)に使用するフォントを有効なSystem.Drawing.Fontに設定します。 |
WatermarkTitle |
PDFドキュメント上のウォーターマーク(透かし)のタイトルとして使用するテキスト(例: CONFIDENTIAL)を入力します。 |
PDFは印刷に最適な形式であると同時に、見出しマップ、ブックマーク、ハイパーリンクなどの対話的な機能もサポートしています。ただし、描画時に非表示になっていたデータ(ドリルダウンレポートのデータなど)は出力されません。したがって、描画前に折りたたまれた項目をすべて展開しておくことを推奨します。